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SECTION 1 



INTRODUCTION 



The assembler translates a symbolic 8080 assembly language 
program "source code" into the binary instructions "object 
code" required by the computer to execute the program. 

The assembler operates on standard CP/M text files. Each 
line of a normal text file consists of the characters of 
that line followed by a carriage return (ODH) and a line 
feed (OAH) . 

When the assembler is invoked, it is loaded into memory 
starting at location 100H. It processes the source code 
file in two passes. On the first pass, it builds a symbol 
table containing all of the labels defined in the source 
program. The symbol table begins at the memory location 
immediately following the assembler; each entry in the table 
is 7 bytes long. Certain errors may be detected during the 
first pass, causing error messages to be output to an error 
file (usually the console) . On the second pass, the object 
code is generated and usually output to an object code file. 
In addition, a formatted listing of both source and object 
code may be output to a listing file, and the symbol table 
may be output to a file. Any errors detected during this 
pass cause messages to be output to the error file. 

To abort the assembly process at any time, press the Control 
and C keys. 

After the assembly runs to completion and no errors are 
detected, the resulting object code file (type .OBJ) can be 
executed by typing RUNA and its name. 

EXAMPLE: 

RUNA PROG loads and executes a file called PROG. 
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SECTION 2 
OPERATING PROCEDURES 

HARDWARE REQUIREMENTS 

1. 8080/Z80/8085 microprocessor. 
Z80 is a trademark of Zilog. 

2. A minimum of 32K RAM. 

3. Any disk drive. 

4. CRT or Video display and keyboard. 

SOFTWARE REQUIREMENTS 

Digital Research Corp's CP/M operating system 

Version 1.4 or 2.2. 

CP/M is a trademark of Digital Research Corp. 



FILES ON THE DISTRIBUTION DISKETTE 

ASSM.COM is the assembler program. 
RUNA.COM is the runtime loader. 



FILE TYPE CONVENTIONS 

Assembly source code files .ASM 

COBOL source code files .CBL 

FORTRAN source code files .FOR 

Object code run time files .OBJ 

Printer listing files .PRN 

Symbol table listing files .SYM 

Error files .ERR 

Work files .WRK 



GETTING STARTED 

First, prepare a CP/M system's diskette for use as your 
NEVADA ASSEMBLER operations diskette. ' 

Then insert the newly created CP/M diskette in disk drive A, 
and insert the NEVADA ASSEMBLER diskette in drive B and type 
Control C to initialize CP/M. Now copy all the files from 
the NEVADA ASSEMBLER diskette onto the CP/M diskette. 

PIP A:=B:*.*[V0] 

At this point, put the NEVADA ASSEMBLER diskette in a safe 
place. You will not need it unless something happens to 
your operations diskette. By the way, back up your 
operations diskette with a copy each week! If your system 
malfunctions you can then pat yourself on the back for 



5-28-82 NEVADA ASSEMBLER PAGE 5 

having a safe back up copy of your work. 

Now, boot up the newly created NEVADA ASSEMBLER operations 
diskette. Notice that CP/M displays the amount of memory 
for which this version of CP/M has been specialized. The 
amount of memory available determines the size of the 
programs that can be assembled. The more memory available 
the larger the program that can be assembled. 

EXECUTING THE ASSEMBLER 



The assembler is invoked by a CP/M command with the 
following formats. 



FORMAT- 1 : 

ASSM file<CR> 

FORMAT-2: 

ASSM file[.uuu u$#LP0]<CR> 

DESCRIPTION: 

where : 

file = [unit :] source-file-name 

The name of the source code input file. 
This parameter must be present; all others 
are optional. 

[ 1 = optional parameters 

unit: = disk drive unit letter. If this parameter is 
not included, the default drive is used. 

u = the disk drive unit letter or the letter "X" 
for output to the console, or the letter " Z" 
for no output. 

u for position one. 

This single character code, if present, 
represents the drive onto which the listing 
file is to be written. If this argument is 
absent then the listing will be written on 
the default drive. Also, if the character 
is an X the listing will be sent to the 
console. If the character is a Z then no 
listing is produced. 
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u for position two. 

The second letter of the file type 
represents the drive for the object (.OBJ) 
file. If this argument is absent then the 
file will be written on the default drive. 
If this character is a Z then no object 
code file will be produced. 

u for position three. 

The third letter of the file type represents 
the drive for the error (.ERR) file. If this 
argument is absent the console will be used 
to display the errors. This argument must be 
followed by a space or carriage return. 

u for position one of the second set. 

The first letter of the second set of 
arguments represents the drive for the 
symbol (.SYM) file. If this argument is 
absent no symbol table file will be 
produced . 

<$options> Various assembler options may be controlled 

by following the $ with one or more of the 
following option specifiers. The list of 
options is terminated by a carriage return. 
For those options that may be preceded by + 
or -, the + is optional and will be assumed 
if absent. 

+L The source file has line numbers in column 

1-4 of each line. 
-L The source file has no line numbers. 

If neither of these is specified, the 
assembler will examine the first line to 
determine if the file has line numbers. 

# Instructs the assembler to generate its own 

line numbers in the listing in place of 
those in the source file (if any) . 

P Instructs the assembler to paginate output 

to the listing file. The file name of the 
source code file will be printed on the top 
left-hand corner of each page. A page 
number will be printed on the top right-hand 
corner of each page. If a TITL 
pseudo-operation occurs in the source code, 
a one- ot two-line title will be centered at 
the top of each page. 
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0,1,2, or 3 Specifies the spacing on the listing 



= no additional spacing 

1 = 72 column output 

2 = 80 column output (default) 

3 = 132 column output 



EXAMPLES: 



ASSM TST 

ASSM TST.AAX A$-L#P0 



STARTUP 

To assemble your program, type ASSM and the source file 
name. The first thing that happens is the copyright message 
is displayed on the screen and the disk drive(s) begin 
working. When the assembly process is complete, a message 
will be displayed and machine control will return to the 
operating system. 

A>ASSM source-file<CR> 

NEVADA ASSEMBLER (C) COPYRIGHT 1982 

ELLIS COMPUTING 

REV 2.0 ASSEMBLING 

NO ASSEMBLY ERRORS. 4 LABELS WERE DEFINED. 

A> 



EXECUTING THE .OBJ FILE 

To execute the program, type RUNA and the file-name. The 
assembly process creates a file with the extension type of 
(.OBJ). This object program file will be loaded into memory 
and executed. 

A>RUNA file-name 

There are several options that also can be specified with 
the RUNA command. 

RUNA f ile-name[ .ZLC] 

Z = zero^memory before loading the .OBJ file. 

L = -3ad the program but don't execute it. 
Control returns to CP/M. 

C = create a .COM file for later execution. 

Control returns to CP/M. Remember .COM files 
alway begin execution at location 100H. 

Example: 



5-28-82 NEVADA ASSEMBLER PAGE 8 

A>RUNA PROG.ZC this will zero memory and create a file 

named PR0G.COM. 
A>RUNA PROG.L this will load PROG but not execute it. 

NOTE; These object code files (.OBJ), if properly orged, 
can also be loaded and executed by the NEVADA COBOL and 
NEVADA FORTRAN run time packages. 



MEMORY USAGE 

The ASSEMBLER program is read into memory starting at 
location 100H and uses all memory available up to the bottom 
of CP/M. 

The runtime package RUNA loads into memory at location 100H 
and relocates itself to just below CP/M and then begins 
loading your program. 



TERMINATION 

The normal termination of the assembly is signaled by the 
display of the following messages and return to CP/M. 

NO ASSEMBLY ERRORS. 4 LABELS WERE DEFINED. 

A> 



The assembly process can be interupted at any time by 
pressing the Control and C keys. 
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SECTION 3 
STATEMENTS 



INTRODUCTION 

An assembly language program (source code) is a series of 
statements specifying the sequence of machine operations to 
be performed by the program. 

Each statement resides on a single line and may contain up 
to four fields as well as an optional line number. These 
fields, label, operation, operand, and comment, are scanned 
from left to right by the assembler, and are separated by 
spaces. The assembler can handle lines up to 80 characters 
in length. 

LINE NUMBERS 

Line numbers in the range 0000-9999 may appear in columns 
1-4. Line numbers need not be ordered and have no meaning 
to the assembler, except that they appear in listings. Line 
numbers may also make it easier to locate lines in the 
source code file when it is being edited. The disk and 
memory space required for normal text files will be 
increased by five bytes per line if line numbers are used; 
this may become significant for large files. 

If line numbers are not used, the label field starts in 
column 1 and the operation field may not start before column 
2. If line numbers are used, they must be followed by at 
least one space, so the label field starts in column 6 and 
the operand many not start before column 7. 

Once the starting column for the label has been established, 
the same format must be followed throughout the file: either 
all of the lines or none of the lines can have line numbers. 
Any other file(s) assembled along with the main file (using 
COPY pseudo-operation) must conform to the format of the 
main file. 

Example of source statements with line numbers: 



label field must start at column 6. 
operation field starts at column 7 
(minimum) . 

operation field starts one space after 
label . 



Column 




1234567 




0001 


LABEL ORA A 


0002 


JNZ 


NEXT 


0003 


i 




0004 


LOOP 


MOV A,B 


0005 


* 





5-28-82 NEVADA ASSEMBLER PAGE 10 



Example of source statements without line numbers: 

Column 

1234567 

LABEL ORA A label field must start at column 1. 

JNZ NEXT operation field starts at column 2 (minimum) • 

LOOP MOV A,B operation field starts one space after label. 



LABEL FIELD 

The label field must start in column 1 of the line (column 6 
if line numbers are used) . A label gives the line a 
symbolic name that can be referenced by any statement in the 
program. Labels must start with an alphabetic character 
(A-Z,a-z) , and may consist of any number of characters, 
though the assembler will ignore all characters beyond the 
fifth; e.g. the labels BRIDGE, BRIDG and BRIDGET cannot be 
distinguished by the assembler. A duplicate label error 
will occur if any two labels in a program begin with the 
same five letters. 

A label may be separated from the operations field by a 
colon (:) insteat of, or in addition to, a blank. 

The labels A, B, C, D, E, H, L, M, PSW, and SP are 
pre-defined by the assembler to serve as symbolic names for 
the 8080 registers. They must not appear in the label 
field. 

An asterisk (*) or semi-colon (;) in place of a label in 
column 1 (column 6 if line numbers are used) will designate 
the entire line as a comment line. 



OPERATION FIELD 



1 V» C* _ _ _ _ _____ 

X 11 *_3 U- J. UV^ U1U U 



_L — —--——- — — — _ - -- _ — — — _ _ _____ _ _-_-„ _ — __ — _ _____ 

mnemonics or assembler pseudo-operation mnemonics. Appendix 
1 summarizes the standard instruction mnemonics recognized 
by the assembler, and Appendix 4 lists several references to 
consult if more information on the 8080 machine instructions 
is needed. Assembler pseudo-operations are directives that 
control various aspects of the assembly process, such as 
storage allocation, conditional assembly, file inclusion, 
and listing control. 

An operation mnemonic may not start before column 2 (column 
7 if line numbers are used) and must be separated from a 
label by at least one space (or a colon) . 
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OPERAND FIELD 

Most machine instructions and pseudo-operations require one 
or two operands, either register names, labels, constants, 
or arithmetic expressions involving labels and constants. 

The operands must be separated from the operator by at least 
one space. If two operands are required, they must be 
separated by a comma. No spaces may occur within the 
operand field, since the first space following the operands 
delimits the comments field. 

Register Names 

Many 8080 machine instructions require one or two registers 
or a register pair to be designated in the operand field. 
The symbolic names for the general-purpose registers are A, 
B, C, D, E, H and L. SP stands for the stack pointer, while 
M refers to the memory location whose address is in the HL 
register pair. The register pairs BC, DE , and HL are 
designated by the symbolic names B, D, and H, respectively. 
The A register and condition flags, when operated upon as a 
register pair, are given the symbolic name PSW. 

The values assigned to be register names A, B, C, D, E, H, 
L, M, PSW and SP are 7, 0, 1, 2, 3, 4, 5, 6, 6, and 6, 
respectively. These constants, or any label or expression 
whose value lies in the range to 7, may be used in place 
of the pre-defined symbolic register names where a register 
name is required; such a substitution of a value for the 
pre-defined register name is not recommended, however. 

Labels 

Any label that is defined elsewhere in the program may be 
used as an operand. If a label is used where an 8-bit 
quantity is required (e.g., MVI C, LABEL), its value must lie 
in the range -256 to 255, or it will be flagged as a value 
error. 

If a label is used as a register name, its value must lie in 
th range to 7, or be 0, 2, 4, or 6 if it designates a 
register pair. Otherwise, it will be flagged as a register 
error. 

During each pass, the assembler maintains an instruction 
location counter that keeps track of the next location at 
which an instruction may be stored; this is analogous to the 
program counter used by the processor during program 
execution to keep track of the location of the next 
instruction to be fetched. 
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The special label $ (dollar Sign) stands for the current 
value of the assembler's instruction location counter. When 
$ appears within the operand field of a machine instruction, 
its value is the address of the first byte of the next 
instruction. 



EXAMPLE: 

FIRST EQU $ 

TABLE DB ENTRY 
* 

* 
* 

LAST EQU $ 

TABLN EQU LAST-FIRST deletions are made in the table. 



The label FIRST is set to the address 
of the entry in a table and LAST 
points to the location immediately after 
the end of the table. TABLN is then 
the length of the table and will remain 
correct, even if later additions or 



CONSTANTS 



Decimal, hexadecimal, octal, binary and ASCII constants may 
be used as operands. 

The base for numeric constants is indicated by a single 
letter immediately following the number, as follows: 

D = decimal 

H = hexadecimal 

= octal 

Q = octal 

B = binary 

If the letter is omitted, the number is assumed to be 
decimal. Q is usually perferred for octal constants, since 
is so easily confused with (zero) . Numeric constants 
must begin with a numeric, character (0-9) so that they can 
be distinguished from labels; a hexadecimal constant 
beginning with A-F must be preceded by a zero. 

ASCII constants are one or two characters surrounded by 
single quotes (')• A single quote within an ASCII constant 
is represented by two single quotes in a row with no 



intervening spaces. For example, the expression 



where 



the two outer quote marks represent the string itself, i.e., 
the single quote character. A single character ASCII 
constant has the numerical value of the corresponding ASCII 
code. A double character ASCII constant has the 16-bit 
value whose high-order byte is the ASCII code of the first 
character and whose low-order byte is the ASCII code of the 
second character. 

If a constant is used where an 8-bit quantity is required 
(e.g., MVI C,10H), its numeric value must lie in the range 
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-256 to 255 or it will be flagged as a value error. 

If a constant is used as a register name, its numeric value 
must lie in the range to 7, or be 0, 2, 4, or 6 if it 

designates a register pair. Otherwise it will be flagged as 
a register error. 

Examples: 

MVI A, 128 Move 128 decimal to register A. 

MVI C,10D Move 10 decimal to register C. 

LXI H,2FH Move 2F hexadecimal to registers HL. 

MVI B,303Q Move 303 octal to register B. 

MVI.A,'Y' Move the ASCII value for Y to reg A. 

MVI A,101B Move 101 binary to register A. 

JMP OFFH Jump to address FF hexadecimal. 



EXPRESSIONS 

Operands may be arithmetic expressions constructed from 
labels, constants, and the following operators: 

+ addition or unary plus 

subtraction or unary minus 
* multiplication 

/ division (remainder discarded) 

Values are treated as 16-bit unsigned 2's complement 
numbers. Positive or negative overflow is allowed during 
expression evaluation, e.g., 32767+l=7FFFH+l=-32768 and 
-32768-l=7FFFH=32767. Expressions are evaluated from left 
to right; there is no operator precedence. 

If an expression is used where an 8-bit quantity is required 
(e.g., MVI C,TEMP + 10H) , it must evaluate to a value in the 
range -256 to 255, or it will be flagged as a value error. 



Examples : 



MVI A,255D/10H-5 

LDA POTTS/256*OFFSET 

LXI SP,30*2+STACK 



High- and Low-order Byte Extraction 



If an operand is preceded by the symbol <, the high-order 
byte of the evaluated expression will be used as the value 
of the operand. If an operand is preceded by the symbol >, 
the low-order byte will be used. 
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Note that the symbols < and > are not operators that may be 
applied to labels or constants within an expression. If 
more than one < or > appears within an expression, the 
rightmost will be used to determine whether to use the high- 
or low-order byte of the evaluated expression as the value 
of the operand. That is f the rightmost < or > is treated as 
if it preceded the entire expression, and the others will be 
totally ignored. 



Examples: 



MVI A,>TEST Loads register A with the least 

* significant 8 bits of the value of 

* the label TEST. 

MVI B,<0CC00H Loads register B with the most 

* significant byte of the 16-bit value 

* CCOOH, i.e., CCH. 

MVI C,<1234H Loads register C with the value 12H. 

MVI C,>1234H Loads register C with the value 34H. 



COMMENT FIELD 

The comment field must be separated from the operand field 
(or operation field for instructions or pseudo-operations 
that require no operand) by at least one space. Comments 
are not processed by the assembler, but are solely for the 
benefit of the programmer. Good comments are essential if a 
program is to be understood very long after it is written or 
is to be maintained by someone other than its author. 

An entire line will be treated as a comment if it starts 
with an asterisk (*) or semicolon (;) in column 1 (column 6 
if line numbers are used) . 

Examples : 

0001 ; is input ready? 

0002 LOOP IN STAT input device status 

0003 ANI 1 test status bit 

0004 JZ LOOP wait for data 

0005 *data is now available 

If listing file formatting is specified in the ASM command 
($=options contains 1, 2, or 3) , the comment field must be 
preceded by at least two spaces to ensure proper output 
formatting. Futhermore, instructions and pseudo-operations 
requiring no operand must be followed by a dummy operand (a 
peRiod is recommended) . 



Examples : 



MVI A, 10 comments 
RZ . comments 
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SECTION 4 



PSEUDO-OPERATIONS 



Pseudo-operations appear in a source program as instructions 
to the assembler and do not always generate object code. 
This section describes the pseudo-operations recognized by 
the NEVADA assembler. 

In the following pseudo-operation formats, <expression> 
stands for a constant, label, arithmetic expression 
constructed from constants and labels. Optional elements 
are enclosed in square brackets [] . 



Equate <label> EQU <expression> 

This pseudo-operation sets a label name to the 16-bit value 
that is represented in the operand field. That value holds 
for the entire assembly and may not be changed by another 
EQU. 

Any label that appears in the operand field of an EQU 
statement must be defined in a statement earlier in the 
program. 

Examples : 

BELL EQU 7 The value of the label BELL is set to 7. 

BELL2 EQU BELL*2 The label BELL2 is ste to 7*2. 



Set Origin [<label>] ORG <expression> 



This pseudo-operation sets the assembler's instruction 
location counter to the 16-bit value specified in the 
operand field. In other words, the object code generated by 
the statements that follow must be loaded beginning at the 
specified address in order to execute properly. The label, 
if present, is given the specified 16-bit value. 

Any label that appears in the operand field of an ORG 
statement must be defined in a statement earlier in the 
program. 

If no origin is specified at the beginning of the source 



Examples : 




* 


ORG 


4000H 


* 






START 
* 


ORG 


100H 
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code, the assembler will set the origin to 100H. If no ORG 
pseudo-operation is used anywhere in the source program, 
successive bytes of object code will be stored at successive 
memory locations. 



Determines that the object code generated 
by subsequent statements must be loaded 
in locations beginning at 4000H. 
Determines that the object code generated 
by subsequent statements must be loaded 
in locations beginning at 100H. 



Set Execution Address XEQ <expression> 

This pseudo-operation specifies the entry point address for 
the program, i.e., the address at which it is to begin 
execution. If a program contains no XEQ pseudo-operation, 
the object code file will contain a starting address of 
100H. If more than one XEQ appears in a program, the last 
will be used. 

An example of the difference between ORG and XEQ is that a 
program whose first 100 bytes are occupied by data will have 
an ORG address 100 bytes lower in memory than its XEQ 
address. 



Example : 



XEQ 100H The entry point address for the assembled 
program is set to 100H. 



Define Storage [<label>] DS <expression> 

[<label>] RES <expression> 

Either of these pseudo-operations reserves the specified 
number of successive memory locations starting at the 
current address within the program. The contents of these 
locations are not defined and are not initialized at load 
time. 

Any label that appears in the operand field of a DS or RES 
statement must be defined in a statement earlier in the 
program. 
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Examples : 

SPEED DS 1 
DS 400 
RES 177Q 



Reserves one byte. 
Reserves 400 bytes. 
Reserves 177 (octal) bytes 



Define byte 



[<label>] DB <expression> [ ,<expression> r . . .] 



This pseudo-operation sets a memory location to an 8-bit 
value. If the operand field contains multiple expressions 
separated by commas, the expressions will define successive 
bytes of memory beginning at the current address. Each 
expression must evaluate to a number that can be represented 
in 8 bits. 

Examples: 

DB 1 one byte is defined. 

DB 0FFH,303Q,100D,11010011B,3*BELL,-10 multiple bytes. 
TABLE DB ' A 1 , * B' , * C ' , ' D' , multiple bytes are defined. 



Define Word 



[<label>] DW <expression> 



This pseudo-operation sets two memory locations to a 16-bit 
quantity. The least significant (low-order) byte of the 
value is stored at the current address and the most 
significant byte (high-order) is stored at the current 
address + 1. 



Examples : 

SAVE DW 1234H 
* 

* 

YES DW 'OK' 
* 

* 



1234H is stored in memory, 34H in the 

low-order byte and 12H in the high-order 

byte . 

The ASCII value for the letters '0' and 'K' 

is stored with the 'K' at the lower memory 

address. 



Define Double Byte 



[<label>] DDB <expression> 



This pseudo-operation is almost the same as DW, except that 
the two bytes are stored in the opposite order: high-order 
byte first, followed by the low-order byte. 
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Example: 

FIRST DDB 1234H 1234H is stored in memory, 12H in the 

; low-order byte and 34H in the high-order 

; byte . 



Define ASCII String [<label>] ASC #<ASCII string># 

[<label>] ASCZ #<ASCII string># 

The ASC pseudo-operation puts a string of characters into 
successive memory locations starting at the current 
location. The special symbols # in the format are 
"delimiters"; they define the beginning and end of the ASCII 
character string. The assembler uses the first non-blank 
character found as the delimiter. The string immediately 
follows this delimiter, and ends at the next occurence of 
the same delimiter, or at a carriage return. 

The ASCZ pseudo-operation is the same except that it appends 
a NUL (00H) to the end of the stored string. 

Examples : 

WORDS ASC "THIS IS AN ASCII STRING" 
ASCZ "THIS IS ANOTHER STRING" 



Set ASCII List Flag ASCF 

ASCF 1 

If the operand field contains a 0, the listing of the 
assembled bytes of an ASCII string will be suppressed after 
the first line (four bytes). Likewise, only the first four 
assembled bytes of a DB pseudo-operation with multiple 
arguments will be listed. If a program contains many long 
strings, its listing will be easier to read if the ASCF 
pseudo-operation is used. 

If the operand field contains a 1, the assembled form of 
subsequent ASCII strings and DB pseudo-operations with 
multiple argumrnts will be listed in full. This is the 
default condition. 
See Appendix 3 for an example of the listing format. 
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Conditional Assembly IF <expression> 

source code 

ENDF 

The value of the expression in the operand field governs 
whether or not subsequent code up to the matching ENDF will 
be assembled. If the expression evaluates to a (false) , 
the code will not be assembled. If the expression evaluates 
to a non-zero value (true) , the code will be assembled. 
Blocks of code delimited by IF and ENDF ("conditional code") 
may be nested within another block of conditional code. 

Any label that appears in the operand field of an IF... ENDF 
pseudo-operation must be defined in a statement earlier in 
the program. 

Example : 

YES EQU 1 Sets the value of the label 'YES' to 1. 

NO EQU Sets the value of the label 'NO' to 0. 
* 

IF YES the expression here is true (1) , so the 

MVI A,'Y' code on this line will be assembled. 

IF NO The expression here is false (0) , so the 

MVI A,'N' code on this line will not be assembled. 

ENDF This terminates the NO conditional. 

ENDF This terminates the YES conditional. 

List Conditional code IFLS 



This pseudo-operation enables listing of conditional source 
code even though no object code is being generated because 
of a false IF condition. The assembler will not list such 
conditional source code if this pseudo-operation is not 
used . 



Copy file COPY [<unit:>] <f ile-name> 

This pseudo-operation copies source code from a disk file 
into a program being assembled. The code from the copied 
file will be assembled starting at the current address. 
When the copied file is exhausted, the assembler will 
continue to assemble from the original file. The resulting 
object code will be exactly like what would be generated if 
the copied source code were part of the original file, but 
the COPY pseudo-operation does not actually alter any source 
file. 

* :_J C i 1 ~ ... ~^4- „~v>„ ->~«4-U«v fi'1 Q Tin A all filoc 
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that are accessed by the COPY pseudo-operation must be of 
the same format as the main source file, i.e., either having 
or not having line numbers. The files must be type (.ASM) . 

EXAMPLES: 

COPY FILE1 
COPY B:FILE2 



Listing Control NLST 

LST 

The NLST pseudo-operation suppresses all output to the 
listing file. Object code will still be output to the 
object code file and the lines containing errors will still 
be output to the error file. The LST pseudo-operation 
re-enables output to the listing file. 



Listing Title TITL <first line>"< second line> 

If the P option is specified in the ASM command, the one- or 
two-line title specified by this pseudo-operation will be 
printed centered at the top of each page of the listing. 



Page Eject PAGE 

If the P option is specified in the ASM command, this 
pseudo-operation causes a skip to the top of the next page 
of the listing. 



End of Source file END 

This pseudo-operation terminates each pass of the assembly. 
Only one END statement should be in the file or files to be 
assembled, and it should be the last statement encountered 
by the assembler. Since an end-of-file on the sourec code 
input file will also terminate each pass, the END statement 
is unnecessary in most cases. 
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SECTION 5 



ERROR CODES AND MESSAGES 



ASSEMBLER COMMAND ERRORS 



A number of console messages may be generated in response to 
errors in the ASM command. When an error of this sort 
occurs, the assembly is aborted and control returns to CP/M. 



EXPECTED NAME The source code input file name is missing. 
ILLEGAL OPTION An unrecognized option specifier follows $. 

91 ERROR IN EXTENDING THE FILE 

92 END OF DISK DATA - DISK IS FULL 

93 FINE NOT OPEN 

94 NO MORE DIRECTORY SPACE - DISK IS FULL 

95 FILE CANNOT BE FOUND 

96 FILE ALREADY OPEN 

97 READING UNWRITTEN DATA 



ASSEMBLY ERRORS 

If a statement contains one of the following 
will be a single letter error code in column 19 
output to the listing and/or error files. An e 
during both the first and the second pass of t 
will be flagged twice in the listing(s). If 
not an opcode error, NULs will be output as the 
if appropriate, third bytes of object co 
instruction. If the error is an opcode 
instruction will be assumed to be a three-byte 
and three NULs will be written to the listing 
files. The error codes are: 



errors, there 

of the line 

rror detected 

he assembler 

the error is 

second and , 

de for that 

error, the 

instruction , 

and/or error 
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ARGUMENT ERROR An illegal label or constant appears 

in the operand field. This might be 
1) a number with a letter in it, 
e.g., 2L f 2) a label that starts 
with a number, e.g., 3ST0P, or 3) an 
improper representation of a string, 
e.g., ' ■ 'A' ' ' in the operand field 
of a statement containing the ASCII 
pseudo-operation. 

DUPLICATE LABEL The source code contains multiple 

labels whose first five characters 
are identical. 



LABEL ERROR 



The symbol in the label field 
contains illegal characters, e.g., 
it starts with a number. 



M 



R 



MISSING LABEL 



OPCODE ERROR 



An EQU instruction does not have a 
symbol in the label field. 

The symbol in the operation field is 
not a valid 8080 instruction 
mnemonic or an assembler 
pseudo-operation mnemonic. 



REGISTER ERROR An expression used as a register 

designator does not have a legal 
value . 



U 



V 



SYNTAX ERROR 



A statement is not in the format 
required by the assembler. 



UNDEFINED SYMBOL A label used in the operand field 

is not defined, i.e., does not 
appear in the label field anywhere 
in the program, or is not defined 
prior to its use as an operand in 
an EQU, ORG, DS, RES, or IF 
pseudo-operation. 



VALUE ERROR 



The value of the operand lies 
outside the allowed range. 



JUMP 




Adr 



CALL 


RETURN 


CD CALL'' 


C9 


RET 


C4 CNZ 


CO 


RNZ 


CC CZ 


C8 


RZ 


V D4 CNC 


DO 

) Adr D8 

EO 


RNC 


DC CC 


RC 


E4 CPO 


RPO 


EC CPE 


E8 


RPE 


F4 CP 


FO 


RP 


FC CM j 


F8 


RM 



MOVE 






Ace 






IMMEDIATE 




IMMEDIATE 


06 MVI 


B. ^ 




C6 


ADI ' 




OE MVI 


C. 




CE 


ACI 




16 MVI 


D. 




D6 


SUI 




1E MVI 


E. 


^D8 


DE 


SBI V 


26 MVI 


H. 


E6 


ANI 


j 


2E MVI 


L. 




EE 


XRI 




36 MVI 


M. 




F6 


ORI 




3E MVI 


A. J 




FE 


CPI J 





D8 



INCREMENT** 



04 INR 

OC INR 

14 INR 

1C INR 



?4 
2C 
34 



INR 
INR 
INR 



3C INR 



03 INX B 

13 INX D 

23 INX H 

33 INX SP 



DECREMENT** 

05 DCR B 

OD DCR C 

15 DCR D 

1D DCR E 

25 DCR H 

2D DCR L 

35 DCR M 

3D DCR A 

OB DCX B 

1B DCX D 

2B DCX H 

3B DCX SP 



LOAD 
IMMEDIATE 

01 LXI B. 

11 LXI D. 

21 LXI H. 

31 LXI SP. 



DOUBLE ADDt 

09 DAD B 
19 DAD D 
29 DAD H 
39 DAD SP 



LOAD/STORE 

OA LDAX B 

1A LDAX D 

2A LHLD Adr 

3A LDA Adr 

02 STAX B 

12 STAX D 

22 SHLD Adr 

32 STA Adr 



D8 constant, or logical arithmetic expression that evaluates 
to an 8 bit data quantity. 

all Flags (C.Z.S.P) affected 



D16 



RESTART 




C7 


RST 





CF 


RST 


1 


D7 


RST 


2 


DF 


RST 


3 


E7 


RST 


4 


EF 


RST 


5 


F7 


RST 


6 


FF 


RST 


7 



STACK OPS 

C5 PUSH B 

D5 PUSH D 

E5 PUSH H 

F5 PUSH PSW 

C1 POP B 

D1 POP D 

E1 POP H 

F1 POP PSW 

E3 XTHL 

F9 SPHL 



SPECIALS 

EB XCHG 

27 DAA* 

2F CMA 

37 STC 

3F CMC 



INPUT/OUTPUT 

D3 OUT D8 
DB IN D8 



ROTATE* 

07 RLC 

OF RRC 

17 RAL 

1F RAR 



MOVE (cont) 



ACCUMULATOR* 



CONSTANT 
DEFINITION 



CONTROL 


00 


NOP 


76 


HLT 


F3 


Dl 


FB 


El 



MOVE 



40 


MOV 


B.B 


41 


MOV 


B.C 


42 


MOV 


B.D 


43 


MOV 


B.E 


44 


MOV 


B.H 


45 


MOV 


B.L 


46 


MOV 


B.M 


47 


MOV 


B.A 


48 


MOV 


C.B 


49 


MOV 


CC 



4A 
4B 
4C 
4D 
4E 
4F 

50 
51 
52 
53 
54 
55 
56 
57 



MOV CD 

MOV CE 

MOV C.H 

MOV C.L 

MOV CM 

MOV CA 

MOV D.B 

MOV D.C 

MOV D.D 

MCV D.E 

MOV D.H 

MOV D.L 

MOV D.M 

MOV D.A 



MOV E.B 

MOV E.C 

MOV E.D 

MOV E.E 



58 

59 

5A 

5B 

5C MOV E.H 

5D MOV E,L 
MOV E.M 
MOV E.A 



5E 
5F 



60 
61 
62 
63 
64 
65 
66 
67 



MOV H.B 

MOV H.C 

MOV H.D 

MOV H.E 

MOV H.H 

MOV H.L 

MOV H.M 

MOV H.A 



MOV L.B 

MOV L.C 

MOV L.D 

MOV L.E 

6C MOV L.H 

6D MOV L.L 

MOV L.M 

MOV L,A 



68 
69 
6A 
6B 



6E 
6F 



70 
71 
72 
73 
74 
75 



MOV M.B 

MOV M.C 

MOV M.D 

MOV M.E 

MOV M.H 

MOV M.L 



77 MOV M.A 



78 
79 
7A 
7B 
7C 



MOV A.B 

MOV A.C 

MOV A.D 

MOV A.E 

MOV A.H 

7D MOV A,L 

7E MOV A.M 

7F MOV A.A 



D16 - constant, or logical/arithmetic expression that evaluates 
to a 16 bit data quantity. 

+ = only CARRY affected 



APPENDIX L 



80 
81 
82 
83 
84 



ADD B 

ADD C 

ADD D 

ADD E 

ADD H 

85 ADD L 

86 ADD M 

87 ADD A 



88 
89 



ADC B 
ADC C 



6A ADC 
8B ADC 



8C ADC H 

8D ADC L 

8E ADC M 

8F ADC* A 

90 SUB B 

91 SUB C 

92 SUB D 

93 SUB E 

94 SUB H 

95 SUB L 

96 SUB M 

97 SUB A 

98 SBB B 

99 SBB C 
9A SBB D 
9B SBB E 
9C SBB H 
9D SBB L 
9E SBB M 
9F SBB A 

AO ANA B 

A1 ANA C 

A2 ANA D 

A3 ANA E 

A4 ANA H 

A5 ANA L 

A6 ANA M 

A7 ANA A 



Adr = 16 bit address 

•• = all Flags except CARRY affected 
(exception: INX & DCX affect no 



A8 


XRA 


B 






A9 


XRA 


C 


OBDH 


Hex 


AA 


XRA 


D 


1AH 


AB 


XRA 


E 




AC 


XRA 


H 


105d1^ 


AD 


XRA 


L 


1Q5 Decimal 


AE 


XRA 


M 


I 


AF 


XRA 


A 


720 
72Q 


Octal 


BO 


ORA 


B 




B1 


ORA 


C 


i ioiibI _. 


B2 


ORA 


D 


00110B B,na,V 


B3 


ORA 


E 


I 


B4 


ORA 


H 


TEST' 




B5 


ORA 


L 


A B' 


ASCII 


B6 


ORA 


M 






B7 


ORA 


A 


OPERATORS 


B8 


CMP 


B 




B9 


CMP 


C 




BA 


CMP 


D 




BB 


CMP 


E 




BC 


CMP 


H 


+• . — 


BD 


CMP 


L 




BE 


CMP 


M 




BF 


CMP 


A 




PSEUDO 




STANDARD 


INSTRUCTION 


SETS 








m 


ORG Adr 




A SET 7 ^ 


END 






B SET O 


EQL 


D16 




C SET 1 ^ 
D SET 2 J> 


DS 


D16 




E SET 3 S 


DB 


D8 


I I 


H SET 4 § 


DW 


D16 


f I 


L SET 5 dd 
M SET 6 S 
SP SET 6 =o 
PSWSET 6 



Flags) 



Ul 



00 
01 
02 



NOP 

LXI 

STAX 



03 INX 

04 INR 



CB 
OC 



'F 
20 
21 
22 
23 
24 
25 
26 
27 



DCR 

MVI 

RLC 



05 

06 

07 

08 

09 DAD 

OA LDAX 



DCX 
INR 



OD DCR 

OE MVI 

OF RRC 

10 --■ 

11 

12 

13 

14 

15 

16 

17 

18 

19 DAD 

1A LDAX 

1B DCX 

1C INR 

1D DCR 

1E MVI 



LXI 

STAX 

INX 

INR 

DCR 

MVI 

RAL 



RAR 

LXI 

SHLD 

INX 

INR 

DCR 

MVI 

DAA 



B.D16 

B 

B 

B 

B 

B.D8 



B 
B 
B 
C 
C 
C.D8 



D.D16 

D 

D 

D 

D 

D.D8 



D 
D 
D 
E 
E 
E.D8 



H.D16 
Adr 
H 
H 
H 
H.D8 



28 

29 DAD 
2A LHLD 
2B DCX 
2C INR 
2D DCR 
MVI 
CMA 



2E 
2F 
30 
31 
32 
33 
34 
35 



41 
42 
43 
44 
45 
46 
47 
48 
49 



LXI 

STA 

INX 

INR 

DCR 



36 MVI 

37 STC 

38 •-■ 

39 DAD 
3A LDA 
3B DCX 
3C INR 
3D DCR 
3E MVI 
3F CMC 

40 MOV 



MOV 
MOV 
MOV 
MOV 
MOV 
MOV 
MOV 
MOV 
MOV 



4A MOV 

4B MOV 

4C MOV 

4D MOV 

4E MOV 

4F MOV 



H 

Adr 
H 
L 
L 
L.D8 



SP.D16 

Adr 
SP 
M 
M 
M.D8 



SF 

Adr 
SP 
A 
A 
A.D8 

B.B 
B.C 
B.D 
B.E 
B.H 
B.L 
B.M 
B.A 
CB 
OC 
CD 
C.E 
C.H 
CL 
CM 
CA 



MOV D.B 

MOV D.C 

MOV D.D 

MOV D,E 

MOV D.H 

MOV D,L 

MOV D.M 

MOV D.A 

MOV E,B 

MOV E.C 

MOV E.D 

MOV E.E 

MOV E.H 

MOV E.L 

MOV E.M 

MOV E.A 

MOV H.B 

MOV H.C 

MOV H.O 

MOV H,E 

MOV H H 

MOV H.L 

MOV H.M 

MOV H.A 

MOV L.B 

MOV L.C 

MOV L.D 

MOV L.E 



50 

51 

52 

53 

54 

55 

56 

57 

58 

59 

5A 

5B 

5C 

5D 

5E 

5" 

SC 

61 

62 

63 

64 

65 

66 

67 

68 

69 

6A 

6B 

6C MOV L.H 

6D MOV L.L 
MOV L,M 
MOV L.A 
MOV M.B 
MOV M.C 
MOV M.D 
MOV M.E 
MOV M.H 
MOV M.L 
HLT 
MOV M,A 



6E 
6F 
70 
71 
72 
73 
74 
75 
76 
77 



78 MOV A.B 

79 MOV A,C 
7A MOV A.D 
7B MOV A,E 
7C MOV A.H 
7D MOV A.L 
7E MOV A.M 
7F MOV A.A 

80 ADD B 

81 ADD C 

82 ADD D 

83 ADD E 

84 ADD H 

85 ADD L 
ADD M 

A 
3 
C 
D 

8B ADC E 

8C ADC H 

8D ADC L 

8E ADC M 

8F ADC A 

SUB B 
SUB 
SUB 
SUB 



86 

87 ADD 

88 ADC 

89 ADC 
8A ADC 



C 
D 
E 
SUB H 



SUB L 

SUB M 

SUB A 

SBB B 

SBB C 



9A SBB 

9B SBB 

9C SBB 

9D SBB 

9E SBB 

9F SBB 



AO ANA 

A1 ANA 

A2 ANA 

A3 ANA 

A4 ANA 

A5 ANA 

A6 ANA 

A7 ANA 

A8 XRA 

A9 XRA 

AA XRA 

AB XRA 

AC XRA 

AD XRA 

AE XRA 

AF XRA 

BO ORA 

B1 ORA 

B2 ORA 

B3 ORA 

B4 ORA 

B5 ORA 

B6 ORA 

B7 ORA 

B8 CMP 

B9 CMP 

BA CMP 

BB CMP 

BC CMP 

BD CMP 

BE CMP 

BF CMP 

CO RNZ 

C1 POP 

C2 JNZ 

C3 JMP 

C4 CNZ 

C5 PUSH 

C6 ADI 

C7 RST 



Adr 
Adr 
Adr 

D8 



C8 RZ 

C9 RET 

CA JZ 

CB --- 

CC CZ 

CD CALL 

CE ACI 

CF RST 

DO RNC 

D1 POP 

D2 JNC 

D3 OUT 

D4 CNC 

D5 PUSH 

D6 SUI 

D7 RST 

D8 RC 

D9 --- 

DA JC 

DB IN 

DC CC 

DD --- 

DE SBI 

DF RST 

EO RPO 

E1 POP 

E2 JPO 

E3 XTHL 

E4 CPO 

E5 PUSH 

E6 ANI 

E7 RST 

E8 RPE 

E9 PCHL 

EA JPE 

EB XCHG 

EC CPE 

ED -■-- 

EE XRI 

EF RST 



Adr 
Adr 
D8 



Adr 
D8 
Adr 

D8 



Adr 
D8 
Adr 

D8 



Adr 
Adr 
D8 

Adr 
Adr 
D8 



FO RP 

F1 POP PSW 

F2 JP Adr 

F3 Dl 

F4 CP Adr 

F5 PUSH PSW 

F6 ORI D8 

F7 RST 6 

F8 RM 

F9 SPHL 

FA JM 

FB El 

FC CM 



HEX-ASCII TABLE 



Adr 



Adr 



FD --- 
FE CPI 
FF RST 7 



D8 



HEX-ASCII TABLE 

Non- Printing 



00 
07 
09 



NULL 
BELL 
TAB 



D8 = constant, or logical/arithmetic expression that evaluates 
to an 8 bit data quantity 



D16 = constant, or logical/arithmetic expression that evaluates 
to a 16 bit data quantity. 



OA LF 

OB VT 

OC FORM 

OD CR 

1 1 X-ON 

12 TAPE 

13 X-OFF 
14 

1B ESC 

7D ALT MODE 

7F RUB OUT 



Adr = 16 bit address 



Printing 
30 



31 
32 
33 
34 
35 
36 
37 
38 
39 

41 
42 
43 
44 
45 
46 
47 
48 
49 
4A 
4B 
4C 
4D 
4E 
4F 
50 
51 
52 
53 
54 
55 
56 
57 
58 
59 
5A 



1 
2 
3 
4 
5 
6 
7 
8 
9 

A 
B 
C 
D 

E 

F 

G 

H 

I 

J 

K 

L 

M 

N 

O 

P 

Q 

R 

S 

T 

U 

V 

w 

X 
Y 

Z 



Characters 


40 


@ 


20 


spa< 


21 


i 


22 




23 


# 


24 


$ 


25 


% 


26 


& 


27 




28 


( 


29 


) 


2A 


• 


2B 


4. 


2C 


» 


2D 


- 


2E 


. 


2F 


/ 


3A 


: 


3B 


* 


3C 


< 


3D 


= 


3E 


> 


3F 


9 


5B 


I 


5C 


V 


5D 


l 


5E 


t 


5F 


— 



(A) 
(-) 



33 

CD 
ID 

m 



> 
to 
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APPENDIX 2 
TABLE OF ASCII CODES (Zero Parity) 



Paper tape 


Upper Octal 


Octal 


Decimal 


Hex 


Character 




123 . 4567P 
















| 0000 


000 





00 


ctrl @ 


NUL 






| 0004 


001 


1 


01 


ctrl A 


SOH 


Start of Heading 




| 0010 


002 


2 


02 


Ctrl B 


STX 


Start of Text 




j 0014 


003 


3 


03 


ctrlC 


ETX 


End of Text 


1 * • 


| 0020 


004 


4 


04 


ctrl D 


EOT 


End of Xmit 


• • . 


| 0024 


005 


5 


05 


ctrl E 


ENQ 


Enquiry 


1 •• ■ 


| 0030 


006 


6 


06 


ctrlF 


ACK 


Acknowledge 


| ••• . 


1 0034 


007 


7 


07 


ctrl G 


BEL 


Audible Signal 




| 0040 


010 


8 


08 


ctrlH 


BS 


Back Space 




| 0044 


011 


9 


09 


ctrl I 


HT 


Horizontal Tab 




| 0050^ 


012 


10 


0A 


ctrl J 


LF 


Line Feed 




| 0054 


013 


11 


OB 


ctrlK 


VT 


Vertical Tab 


1 • • • 


| 0060 


014 


12 


OC 


ctrl L 


FF 


Form Feed 


j • • . • 


| 0064 


015 


13 


OD 


ctrlM 


CR 


Carriage Return 


| •• . • 


| 0070 


016 


14 


OE 


ctrlN 


SO 


Shift Out 


j ••• . • 


| 0074 


017 


15 


OF 


Ctrl 


SI 


Shift In 




| 0100 


020 


16 


10 


ctrlP 


DLE 


Data Line Escape 




| 0104 


021 


17 


11 


ctrl Q 


DC1 


XOn 




1 0110 


022 


18 


12 


ctrlR 


DO 


Aux On 




| 0114 


023 


19 


13 


ctrl S 


DC3 


XOff 


1 • • • 


| 0120 


024 


20 


14 


ctrl T 


DC4 


Aux Off 


1 • • . • 


| 0124 


025 


21 


15 


ctrlU 


NAK 


Negative Acknowledge 


• • . • 


| 0130 


026 


22 


16 


ctrl V 


SYN 


Synchronous File 


j ••• . • 


| 0134 


027 


23 


17 


ctrlW 


ETB 


End of Xmit Block 




| 0140 


030 


24 


18 


ctrlX 


CAN 


Cancel 




j 0144 


031 


25 


19 


ctrl Y 


EM 


End of Medium 




1 0150 


032 


26 


1A 


ctrl Z 


SUB 


Substitute 




| 0154 


033 


27 


IB 


ctrl [ 


ESC 


Escape 


j • . •• 


| 0160 


034 


28 


1C 


ctrl\ 


FS 


File Separator 


j • • . •• 


| 0164 


035 


29 


ID 


ctrl ] 


GS 


Group Separator 


| •• . •• 


| 0170 


036 


30 


IE 


ctrl A 


RS 


Record Separator 


j •••.•• 


| 0174 


037 


31 


IF 


ctrl _ 


US 


Unit Separator 




1 0200 


040 


32 


20 


Space 








| 0204 


041 


33 


21 


J 








| 0210 


042 


34 


22 


it 








| 0214 


043 


35 


23 


# 






j • . • 


| 0220 


044 


36 


24 


$ 






j • • . • 


| 0224 


045 


37 


25 


% 






j •• . • 


| 0230 


046 


38 


26 


El 






| ••• . • 


1 0234 


047 


39 


27 


' 








| 0240 


050 


40 


28 


( 








| 0244 


051 


41 


29 


) 








| 0250 


052 


42 


2A 


* 








| 0254 


053 


43 


2B 


+ 






j • . • • 


| 0260 


054 


44 


2C 


) 






• • . • • 


| 0264 


055 


45 


2D 


- 






j •• . • • 


| 0270 


056 


46 


2E 


. 






••• • • * 


| 0274 


057 


47 


2F 


/ 








| 0300 


060 


48 


30 











| 0304 


061 


49 


31 


1 








| 0310 


062 


50 


32 


2 








| 0314 


063 


51 


33 


3 






j • . •• 


1 0320 


064 


52 


34 


4 






j • • . • • 


| 0324 


065 


53 


35 


5 






j •• . •• 


| 0330 


066 


54 


36 


6 






j ••• . •• 


| 0334 


067 


55 


37 


7 








| 0340 


070 


56 


38 


8 






1 • • • • 


j 0344 


071 


57 


39 


9 








| 0350 


072 


58 


3A 


: 








| 0354 


073 


59 


3B 


! 






j • . ••• 


| 0360 


074 


60 


3C 


< 






j • • . ••• 


| 0364 


075 


61 


3D 


= 






j ••.••• 


| 0370 


076 


62 


3E 


> 






j •••.••• 


1 0374 


077 


63 


3F 


? 
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9MS2S* 



APPENDIX 2 
TABLE OF ASCII CODES (Cont'd) (Zero Parity) 



Paper tape 


Upper Octal 


Octal 


Decimal 


Hex 


Character 


123 . 4567P 












| 0400 


100 


64 


40 


@ 




| 0404 


101 


65 


41 


A 




| 0410 


102 


66 


42 


B 




| 0414 


103 


67 


43 


C 


1 • • * 


| 0420 


104 


68 


44 


D 


| • • . • 


| 0424 


105 


69 


45 


E 


j •• . • 


| 0430 


106 


70 


46 


F 


j ••• . • 


| 0434 


107 


71 


47 


G 




1 0440 


no 


72 


48 


H 




| 0444 


111 


73 


49 


I 




| 0450 


112 


74 


4A 


J 




| 0454 


113 


75 


4B 


K 


• . • • 


| 0460 


114 


76 


4C 


L 


j • • . • • 


j 0464 


115 


77 


4D 


M 


j •• . • • 


| 0470 


116 


78 


4E 


N 


• •• . • • 


| 0474 


117 


79 


4F 


O 




| 0500 


120 


80 


50 


P 




| 0504 


121 


81 


51 


Q 




| 0510 


122 


82 


52 


R 




| 0514 


123 


83 


53 


S 


j • . • • 


| 0520 


124 


84 


54 


T 


j • • . • • 


| 0524 


125 


85 


55 


U 


j •• . • • 


| 0530 


126 


86 


56 


V 


j ••• . • • 


| 0534 


127 


87 


57 


w 




| 0540 


130 


88 


58 


X 




| 0544 


131 


89 


59 


Y 




1 0550 


132 


90 


5A 


Z 




| 0554 


133 


91 


5B 


[ 


j • . •• • 


| 0560 


134 


92 


5C 


\ 


j | • • . • • • 


| 0564 


135 


93 


5D 


] 


j •• . •• • 


| 0570 


136 


94 


5E 


A 


!•••.•• • 


| 0574 


137 


95 


5F 






| 0600 


140 


% 


60 


\ 




| 0604 


141 


97 


61 


a 




| 0610 


142 


98 


62 


b 




| 0614 


143 


99 


63 


c 


j • . • • 


| 0620 


144 


100 


64 


d 


j • • . •• 


1 0624 


145 


101 


65 


e 


j •• . •• 


| 0630 


146 


102 


66 


f 


j ••• . •• 


| 0634 


147 


103 


67 


g 




| 0640 


150 


104 


68 


h 




| 0644 


151 


105 


69 


i 




| 0650 


152 


106 


6A 


j 




| 0654 


153 


107 


6B 


k 


j • . • •• 


| 0660 


154 


108 


6C 


1 


j • • . • • • 


j 0664 


155 


109 


6D 


m 


j •• . • •• 


| 0670 


156 


110 


6E 


n 


!•••.• •• 


| 0674 


157 


111 


6F 


o 




| 0700 


160 


112 


70 


P 




| 0704 


161 


113 


71 


q 




| 0710 


162 


114 


72 


r 




| 0714 


163 


115 


73 


s 


j • . ••• 


| 0720 


164 


116 


74 


t 


j • • . ••• 


| 0724 


165 


117 


75 


u 


j •• . ••• 


| 0730 


166 


118 


76 


V 


j ••• , ••• 


| 0734 


167 


119 


77 


w 




| 0740 


170 


120 


78 


X 




| 0744 


171 


121 


79 


y 




| 0750 


172 


122 


7A 


z 




| 0754 


173 


123 


7B 


{ 


j •.•••• 


| 0760 


174 


124 


7C 


1 


j • •.•••• 


| 0764 


175 


125 


7D 


} 


j ••.•••• 


| 0770 


176 


126 


7E 


Prefix 


j •••.•••• 


| 0774 


177 


127 


7F 


CEL Rubout 
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APPENDIX 3 
ASSEMBLER LISTING 





£ 


















6 

£ 

£ 


COMMENT 








0000 


• 














0001 


•SEARCH TABLE FOR MATCH TO STRING 








0002 


•EACH 


TABLE 


E«TRY IS 


FOLLOWED BY A TWO-BYTE DISPATCH ADDRESS 








0003 


•TABLE 


MUST 


'HAVE AT 1 


LEAST ONE ENTRY AND IS TERMINATED BY A 








0004 


•ZERO 


BYTE. 












0005 


•ON ENTRY: 


HL POINTS TO STRING 








0006 


• 




DE POINTS TO TABLE 








0007 


• 




C IS NUMBER OF CHARACTERS IN TABLE ENTRIES 








0008 


•ON RETURN: 


ZERO FLAG SET IF NO MATCH, ELSE DE POINTS TO 








0009 


• 




DISPATCH 


ADDRESS 








0010 


• 








0100 E5 






0011 


TSRCH 


PUSH 


H 


SAVE STRING ADDRESS 


0101 41 






0012 




MOV 


B,C 


INITIALIZE CHARACTER COUNT 


0102 1A 






0013 


TS1 


LDAX 


D 


COMPARE CHARACTERS 


0103 BE 






0014 




CMP 


M 




0104 C2 11 


01 




0015 




JNZ 


TS3 




0107 23 






0016 




INX 


H 


CHARACTERS MATCH , GO ON TO NEXT 


0108 13 






0017 




INX 


D 




0109 05 






0018 




DCR 


B 




010A C2 02 


01 




0019 




JNZ 


TS1 




010D F6 01 






0020 




OR I 


1 


MATCHING ENTRY FOUND 


010F E1 






0021 


TS2 


POP 


H 




0110 C9 






0022 




RET 






0111 B7 






0023 


TS3 


ORA 


A 


TEST FOR END OF TABLE 


0112 CA OF 


01 




0024 




JZ 


TS2 




0115 13 






0025 


TS4 


INX 


D 


SKIP TO NEXT ENTRY 


0116 05 






0026 




DCR 


B 




0117 C2 15 


01 




0027 




JNZ 


TS4 




011A 13 






0026 




INX 


D 




011B 13 






0029 




INX 


D 




one ei 






0030 




POP 


H 




011D C3 00 


01 




0031 
0032 


• 


JMP 


TSRCH 










0033 


•EXAMPLE OF 


TSRCH USE: 








0034 


• 














0035 


•(ASSUME ML 


POINTS TO A FOUR-CHARACTER COMMAND STRING) 


0120 11 35 


01 




003t> 




LXI 


D, CTABL DE POINTS TO COMMAND TABLE 


0123 OE 04 






0037 




MVI 


C,4 


TABLE ENTRIES ARE FOUR CHARACTERS LONG 


0125 CD 00 


01 




0036 




CALL 


TSRCH 




0120 CA 00 


00 


u 


0039 




JZ 


ERROR 


COMMAND NOT IN TABLE 


012B EB 






0040 




XCHG 




SET UP STACK FOR RETURN TO MAIN ROUTINE 


012C 11 00 


00 


u 


0041 




LXI 


D, COMMAND 


012F D5 






0042 




PUSH 


D 




0130 7E 






0043 




MOV 


A,M 


DISPATCH TO APPROPRIATE COMMAND ROUTINE 


0131 23 






00*44 




INX 


H 




0132 66 






0045 




MOV 


H,M 




0133 6F 






0040 




MOV 


L,A 




0134 E9 






0047 
0046 


• 


PCHL 












0049 


•COMMAND TABLE 










0050 


• 








0135 43 4F 


4D 31 




0051 


CTABL 


ASC 


'COM!' 


FIRST ENTRY 


0139 00 00 




u 


0052 




DW 


SUB1 


ADDRESS OF SUB1 


013B 4 3 4F 


4D 32 




0053 




ASC 


'COM2' 


SECOND ENTRY 


013F 00 00 




u 


0054 




DW 


SUB2 


ADDRESS OF SUB2 


0141 00 






0055 




DB 





END OF TABLE MARK 



SYMBOL TABLE LISTING 



Label Addr. Label Addr. Label Addr. Label Addr. 



CTABL 
TS4 



0135 
0115 



TS1 
TSRCh 



0102 
0100 



TS2 



01 OF 



TS3 



0111 



0001 


* 


0002 


* 


0003 


* 


0004 


* 


0005 


* 


0006 


* 


0007 


* 


0008 


* 


0009 


* 


0010 


* 


0011 


* 


0012 


* 


0013 


* 


0014 


* 


0015 


* 


0016 


* 


0017 


* 


0018 


* 


0019 


* 


0020 


* 
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APPENDIX 4 



This is a sample program. The loader source code. 



**************************************************** 

RUNA f ile-name[ .ZCL] 

An .OBJ file consists of one or more segments that 
have the format: 

#BYTES DESCRIPTION 

2 Number of code and data bytes in 

segment 
2 Load address of code and data 

belonging to the segment. 
Variable Code and/or data. 

The run time package will load each segment at the 
specified address until a starting address is 
encountered. A starting address is represented as 
load address with a zero byte count. 

************************************************** 

0021 RELOC EQU ;4200H FOR TRS-80 MOD 1 

0022 BDOS EQU 5+RELOC ;CP/M 

0023 BLKSIZ EQU 128 

0024 OFCB EQU 5CH+RELOC ;IN CP/M 

0025 OEX EQU OFCB+12 

0026 OCR EQU OFCB+32 

0027 OBUF EQU 80H+RELOC ; IN CP/M 

0028 * 

0029 CSTART EQU $ 

0030 LXI SP,STK 

; RETURN VERSION # 



;CPM 1.4 DEFAULT DRIVE 



; 11-30-81 FOR MP/M II 
/DEFAULT DRIVE 

0042 * GET OPTIONS FROM TYPE FIELD 

0043 LXI H,5CH+8 

0044 MVI C,4 

0045 NEXT EQU $ 

0046 INX H 

0047 DCR C 

0048 JZ NOOPTIONS 

0049 MOV A,M 

0050 CPI ' • 



0031 


MVI C,0CH 


0032 


CALL BDOS 


0033 


MOV A,L 


0034 


ORA A 


0035 


JNZ VER2X 


0036 


LDA 4+RELOC 


0037 


CPI 5 


0038 


JC SETDF 


0039 


XRA A 


0040 


SETDF EQU $ 


0041 


STA ODRIVE 
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0051 JZ NOOPTIONS 

0052 CPI 'Z* 

0053 JZ ZEROFIL 

0054 CPI 'C 

0055 JZ COMFILE 

0056 CPI 'L' 

0057 JZ NOEXEC 

0058 * ERROR ILLEGAL OPTION 

0059 LXI H,MESGA 

0060 CALL DISPLAY 

0061 JMP 0+RELOC 

0062 * GET SIZE OF INSTRUCTION 

0063 GETSZ LXI H,TBL-1 

0064 AGAIN MOV A,C 

0065 INX H 



0066 


MOV B,M 


0067 


ANA B 


0068 


JZ BYTE1 


0069 


INX H 


0070 


MOV B,M 


0071 


XRA B 


0072 


INX H 


0073 


JNZ AGAIN 


0074 


MOV A,M 


0075 


RET . EXIT 


0076 


BYTE1 MVI A,l 


0077 


RET . EXIT 


0078 


* 


0079 


REL EQU $ RELOCATION 


0080 


PUSH H 


0081 


PUSH D 


0082 


PUSH PSW 


0083 


INX H 


0084 


MOV E,M 


0085 


INX H 


0086 


MOV A,M 


0087 


ORA A WE DON'T RELOCATE BELOW 100+RELOC 


0088 


JZ NOREL 


0089 


MOV D,A 


0090 


PUSH H 


0091 


LHLD BASE 


0092 


DAD D ADDRESS IS NOW ADJUSTED 


0093 


XCHG 


0094 


POP H 


0095 


MOV M,D PUT IT BACK 


0096 


DCX H 


0097 


MOV M,E 


0098 


NOREL EQU $ 


0099 


POP PSW 


0100 


POP D 


0101 


POP H 


0102 


RET 


0103 


* 


0104 


VER2X EQU $ 


0105 


MVI C,19H ;GET CPM 2.X DEFAULT DRIVE 


0106 


CALL BDOS 


0107 


JMP SETDF 


0108 


* 
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0109 MESGA ASC 'ILLEGAL OPTION 1 

0110 DB 0DH,0AH 

0111 ASC 'RUN D:FILE.ZCL<CR>' 

0112 DB 0DH f 0AH f 

0113 * 

0114 TBL DB -1,11101001B,1 

0115 DB -1,11001101B,3 

0116 DB 11000111B,11000100B,3 

0117 DB -1,11000011B,3 

0118 DB 11000111B,11000010B,3 

0119 DB 11000111B,11000111B,1 

0120 DB -1, 11001001B, 1 

0121 DB 11000111B,11000000B,1 

0122 DB 11001111B,1,3 

0123 DB 11100111B,00100010B, 3 

0124 DB 111101118,110100116,2 

0125 DB 11000111B,6,2 

0126 DB 11000111B,11000110B,2 

0127 DB END OF TABLE 

0128 * 

0129 BASE DW BASE ADJ TO ADD TO ADDRESS TO BE RELOCATED 

0130 START DW STARTING ADDR OF RELOCATED CODE 

0131 * 

0132 ZEROFILL EQU $ 

0133 STA ZX 

0134 JMP NEXT 

0135 * 

0136 COMFILE EQU $ 

0137 STA CX 

0138 JMP NEXT 

0139 * 

0140 NOEXEC EQU $ 

0141 STA LX 

0142 JMP NEXT 

0143 * 

0144 OSET EQU $ 

0145 LXI D,OBUF 

0146 MVI C,26 ;SET DMA 

0147 CALL BDOS 

0148 LDA ODRIVE 

0149 MVI D,0 

0150 MOV E,A 

0151 MVI C,14 ;SET DRIVE 

0152 CALL BDOS 

0153 LXI D,OFCB 

0154 RET 

0155 * 

0156 NOOPTIONS EQU $ 

0157 LXI H,080H+3+RELOC 

0158 MOV A,M 

0159 CPI ':' ;WAS DRIVE REQUESTED? 

0160 JNZ DEFDRIVE ;DEFAULT IS SET 

0161 DCX H 

0162 MOV A,M 

0163 CPI 'A' 

0164 JC DEFDRIVE 

0165 SUI 'A' 

0166 STA ODRIVE 
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0167 


DEFDRIVE EQU $ 


0168 


CALL SETFCB 


0169 


MVI Mj'O' 


0170 


INX H 


0171 


MVI M f 'B' 


0172 


INX H 


0173 


MVI M, 'J' 


0174 


CALL OSET 


0175 


MVI C,15 ;OPEN 


0176 


CALL BDOS 


0177 


CPI -1 


0178 


JZ OERR ;OPEN ERROR 


0179 


XRA A 


0180 


STA OCR 


0181 


* RELOCATE CODE TO JUST BELOW CP/M 


0182 


LHLD 6+RELOC 


0183 


DCX H HIGHEST ADDR 


0184 


LXI B,LAST-LOADFILE SIZE OF CODE TO BE RELOCATED 


0185 


MOV A,L 


0186 


SUB C 


0187 


MOV L,A 


0188 


MOV A,H 


0189 


SBB B 


0190 


MOV H,A 


0191 


; H&L= STARTING ADDRESS 


0192 


SHLD START 


0193 


PUSH H 


0194 


LXI D,LOADFILE 


0195 


MOV A f L 


0196 


SUB E 


0197 


MOV L,A 


0198 


MOV A,H 


0199 


SBB D 


0200 


MOV H,A 


0201 


SHLD BASE 


0202 


POP H 


0203 


LXI B,CONSTANTS-LOADFILE SIZE OF INSTRUCTION MOVE 


0204 


XCHG 


0205 


NXTI EQU $ 


0206 


PUSH H 


0207 


PUSH D 


0208 


PUSH B 


0209 


MOV C,M GET OPCODE 


0210 


CALL GETSZ GET SIZE OF INSTRUCTION 


0211 


POP B 


0212 


POP D 


0213 


POP H 


0214 


CPI 3 


0215 


JC SKPREL 


0216 


CALL REL RELOCATE ADDR IN THIS 3 BYTE INST 


0217 


SKPREL EQU $ 


0218 


PUSH B 


0219 


PUSH PSW 


0220 


MOV C,A SIZE 


0221 


NXTM EQU $ 


0222 


MOV A,M 


0223 


STAX D 


0224 


INX H 
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0225 INX D 

0226 DCR C 

0227 JNZ NXTM 

0228 POP PSW 

0229 POP B 

0230 NXTD EQU $ 

0231 DCX B 

0232 DCR A 

0233 JNZ NXTD 

0234 MOV A,C 

0235 ORA B 

0236 JNZ NXTI 

0237 * RELOCATE CONSTANTS 

2 38 LXI B, LAST-CONSTANTS SIZE OF CONSTANTS 

0239 NXTC EQU $ 

0240 MOV A,M 

0241 STAX D 

0242 INX H 

0243 INX D 

0244 DCX B 

0245 MOV A,C 

0246 ORA B 

0247 JNZ NXTC 

0248 LHLD START 

0249 PCHL . CODE HAS BEEN RELOCATED NOW GO TO IT 

0250 * 

0251 ***************************************************** 

0252 * RUNA A:FILE . OBJ<CR> 

0253 * 

254 * MOVE PARAMETERS AND CHECK 

0255 ***************************************************** 

0256 * 

0257 LOADFILE EQU $ 

0258 LXI SP,STK SET STACK AFTER RELOCATION 

0259 LDA ZX ZERO FILL MEMORY? 

0260 ORA A 

0261 JZ SKPCLR 

0262 LXI D,LOADFILE-l 

0263 MVI H,l STARTING ADDR +RELOC 

0264 MVI L,0 

0265 CLEAR EQU $ 

0266 XRA A 

0267 MOV M r A 

0268 INX H 

0269 MOV A,L 

0270 SUB E 

0271 MOV A,H 

0272 SBB D 

0273 JC CLEAR 

0274 SKPCLR EQU $ 

027 5 CALL ORD ;GET 1ST RECORD OF .OBJ FILE 

0276 OLOAD EQU $ 

0277 CALL GETOP 

278 MAO MOV A,M ;MOVE 4 BYTES FROM BUF TO WORK 

0279 STAX D 

0280 INX H 

0281 INX D 

0282 DCR C 
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0283 
0284 
0285 
0286 
0287 
0288 
0289 
0290 
0291 
0292 
0293 
0294 
0295 
0296 
0297 
0298 
0299 
0300 
0301 
0302 
0303 
0304 
0305 
0306 
0307 
0308 
0309 
0310 
0311 
0312 
0313 
0314 
0315 
0316 
0317 
0318 
0319 
0320 
0321 
0322 
0323 
0324 
0325 
0326 
0327 
0328 
0329 
0330 
0331 
0332 
0333 
0334 
0335 
0336 
0337 
0338 
0339 
0340 



;MOVE FROM BUF TO OBJ ADDR 



CZ ORD 

DCR B 

JNZ MAO 
; H&L = BUFFER C=COUNT 

XCHG 

LHLD OWRK ;SIZE OF NEXT READ 

MOV A f L 

ORA H 

JZ CLOSE 

SHLD OSIZE 

LHLD OWRK+2 

XCHG 
MAOA MOV A,M 

STAX D 

INX H 

INX D 

DCR C 

CZ ORD 

PUSH H 

LHLD OSIZE 

DCX H 

SHLD OSIZE 

MOV A,L 

ORA H 

POP H 

JNZ MAOA 

CALL SAVOP 

JMP OLOAD 

GETOP EQU $ 

LXI D,OWRK 

LHLD OCBA 

MVI B,4 

LDA OCBC 

MOV C,A 

RET 
* 

ORD EQU $ 

PUSH B 

PUSH D ;OPNT 

LXI D,OFCB 

MVI C,20 ;READ 

CALL BDOS 

POP D 

POP B 

ORA A 

JNZ RERR 

LXI H,OBUF 

MVI C,BLKSIZ 

RET 
* 

SAVOP EQU $ 
SHLD OCBA ;BUFF ADDR 
MOV A,C 



;GET POINTERS 

;BUF ADDR 
; LENGTH OF WRK 
;BUF CNT 



STA OCBC 
LDA HIGH 
CMP D . 
RNC 



;BUF CNT 
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0341 
0342 
0343 
0344 
0345 
0346 
0347 
0348 
0349 
0350 
0351 
0352 
0353 
0354 
0355 
0356 
0357 
0358 
0359 
0360 
0361 
0362 
0363 
0364 
0365 
0366 
0367 
0368 
0369 
0370 
0371 
0372 
0373 
0374 
0375 
0376 
0377 
0378 
0379 
0380 
0381 
0382 
0383 
0384 
0385 
0386 
0387 
0388 
0389 
0390 
0391 
0392 
0393 
0394 
0395 
0396 
0397 
0398 



LOAD BUT DON'T EXECUTE 
/STARTING ADDRESS 



MOV A,D 
STA HIGH 
RET 
* 

CLOSE EQU $ 

LXI D,OFCB 

MVI C,16 ;CLOSE 

CALL BDOS 

LDA CX 

ORA A 

JNZ GENCOM 

LDA LX 

ORA A 

JNZ 0+RELOC 

LHLD OWRK+2 

PCHL 
* 

SETFCB EQU $ 

XRA A 

STA OFCB 

STA OCR 

LXI H,OEX 

MVI C,4 
EXLUP EQU $ ; 10-2-81 ZERO CPM EXT AREA 

MOV M,A 

INX H 

DCR C 

JNZ EXLUP 

LXI H,OBUF 

SHLD OCBA 

MVI A,BLKSIZ 

STA OCBC 

LXI H, 5CH+9+RELOC ;CP/M FILE TYPE 

RET 
* 

CREATE EQU $ 

LXI D,OFCB 

MVI C,22 CREATE 

CALL BDOS 

CPI -1 

RNZ 
OERR EQU $ 

LXI H,MESGO OPEN ERROR 

CALL DISPLAY 

JMP OXT1 

GENCOM EQU $ GENERATE .COM FILE 

CALL SETFCB 

MVI Mj'C' 

INX H 

MVI M,'0' 

INX H 

MVI M,'M* .COM IN FCB 
*OPEN 

LXI D,OFCB 

MVI C,15 OPEN .COM FILE 

CALL BDOS 

CPI -1 
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0399 CZ CREATE 

0400 XRA A 

0401 STA OCR 

0402 *WRITE 

0403 LDA HIGH 

0404 DCR A 

0405 MOV H,A 

0406 MVI L,0FFH 

0407 SHLD SIZ OF THIS WRITE 

0408 MVI D,l STARTING ADDRESS +RELOC 

0409 MVI E,0 

0410 LXI H,OBUF BUFFER ADDRESS 

0411 MVI C,BLKSIZ BUFFER SIZE 

0412 NXTW EQU $ 
413 LDAX D 

0414 MOV M,A 

0415 INX H 

0416 INX D 

0417 DCR C BUFF COUNT 

0418 CZ WRITE 

0419 PUSH H 

0420 LHLD SIZ 

0421 DCX H 

0422 SHLD SIZ 

0423 MOV A,L 

0424 ORA H 

0425 POP H 

0426 JNZ NXTW 

0427 CALL WRITE LAST BLOCK 

0428 * CLOSE 

0429 LXI D,OFCB 

0430 MVI C, 16 CLOSE 

0431 CALL BDOS 

0432 JMP 0+RELOC 

0433 * 

0434 WRITE EQU $ 

0435 PUSH D 

0436 LXI D,OFCB 

0437 MVI C f 21 WRITE 

0438 CALL BDOS 

0439 POP D 

0440 ORA A 

0441 JNZ ERRW 

0442 LXI H,OBUF 

0443 MVI C,BLKSIZ 

0444 RET 

0445 * 

0446 *++************************************************* 

0447 *$$ DISPLAY A MESSAGE TO THE CONSOLE 

0448 * ENTRY H&L CONTAIN STARTING ADDRESS OF THE MESSAGE 

0449 * THE MESSAGE TEXT IS TERMINATED BY HEX 

0450 * CALL DISPLAY 

04 51 * ************************************************** 

0452 * 

0453 DISPLAY EQU $ 

0454 MOV A,M 

0455 ORA A 

0456 RZ . EXIT TO CALLING ROUTINE ** 
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0457 
0458 
0459 
0460 
0461 
0462 
0463 
0464 
0465 
0466 
0467 
0468 
0469 
0470 
0471 
0472 
0473 
0474 
0475 
0476 
0477 
0478 
0479 
0480 
0481 
0482 
0483 
0484 
0485 
0486 
0487 
0488 
0489 
0490 
0491 
0492 
0493 
0494 
0495 
0496 
0497 



MOV E f A 

MVI C,2 

PUSH H 

CALL BDOS ;PUT THE CHAR TO THE CONSOLE 

POP H 

INX H 

JMP DISPLAY 



WRITE ERROR 



READ ERROR 



;FILE NAME 



ERRW EQU $ 

LXI H r MESGW 

CALL DISPLAY 

JMP OXT1 
* 

RERR EQU $ 

LXI H,MESGR 

CALL DISPLAY 
OXT1 EQU $ 

LXI H f OFCB+l 

CALL DISPLAY 

JMP 0+RELOC RETURN TO CP/M 
*************************************************** 

CONSTANTS EQU $ 

HIGH DB HIGHEST PAGE USED FOR .COM 

ZX DB DEFAULT NO CLEAR ;Z=ZERO FILL BEFORE LOADING 

CX DB DEFAULT NO .COM ;C=.COM FILE 

LX DB DEFAULT EXECUTE ;L=LOAD BUT NO EXECUTION 

ODRIVE DB 

OWRK DB 0,0,0,0 

OCBA DW OBUF /CURRENT BUFFER ADDRESS 

OCBC DB BLKSIZ ;CURRENT BUFFER COUNTER 

OSIZE DW ;SIZE OF NEXT OBJ BLOCK 

SIZ DW SIZE OF COM FILE CODE 

MESGO ASC 'OPEN ERROR ' 

DB 
MESGR ASC 'READ ERROR * 

DB 
MESGW ASC 'WRITE ERROR ' 

DB 

DS 30 
STK DB 'S' 
LAST DB 
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OPERAND FIELD 

Most machine instructions and pseudo-operations require one 
or two operands, either register names, labels, constants, 
or arithmetic expressions involving labels and constants. 

The operands must be separated from the operator by at least 
one space. If two operands are required, they must be 
separated by a comma. No spaces may occur within the 
operand field, since the first space following the operands 
delimits the comments field. 

Register Names 

Many 8080 machine instructions require one or two registers 
or a register pair to be designated in the operand field. 
The symbolic names for the general-purpose registers are A, 
B, C, D, E, H and L. SP stands for the stack pointer, while 
M refers to the memory location whose address is in the HL 
register pair. The register pairs BC, DE, and HL are 
designated by the symbolic names B, D, and H, respectively. 
The A register and condition flags, when operated upon as a 
register pair, are given the symbolic name PSW. 

The values assigned to be register names A, B, C, D, E, H, 
L, M, PSW and SP are 7, 0, 1, 2, 3, 4, 5, 6, 5, and 6, 
respectively. These constants, or any label or expression 
whose value lies in the range to 7, may be used in place 
of the pre-defined symbolic register names where a register 
name is required; such a substitution of a value for the 
pre-defined register name is not recommended, however. 

Labels 

Any label that is defined elsewhere in the program may be 
used as an operand. If a label is used where an 8-bit 
quantity is required (e.g., MVI C, LABEL), its value must lie 
in the range -256 to 255, or it will be flagged as a value 
error. 

If a label is used as a register name, its value must lie in 
th range to 7, or be 0, 2, 4, or 6 if it designates a 
register pair. Otherwise, it will be flagged as a register 
error . 

During each pass, the assembler maintains an instruction 
location counter that keeps track of the next location at 
which an instruction may be stored; this is analogous to the 
program counter used by the processor during program 
execution to keep track of the location of the next 
instruction to be fetched. 
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The special label $ (dollar^ Sign) stands^for the current 
value' of the assembler's instruction location counter. When 
$ appears within the operand field of a machine instruction, 
its value is the address of the first byte of the next 
instruction. [""". 

EXAMPLE: 



The label FIRST is set to the address 
of the entry in a table and LAST 
points to the location immediately after 
the end of the" table. TABLN is then 
the length of the table and will remain 
correct, even if later additions or 



FIRST EQU $ 

TABLE DB ENTRY 
* 

* 

LAST EQU $ .■ 

TABLN EQU LAST-FIRST deletions are made in the table. 



CONSTANTS 



Decimal, hexadecimal, octal, binary and.,.ASCII constants may 
be used as operands. 

The base for numeric constants is indicated by a single 
letter immediately following the number, as, follows: 



D 


= 


decimal 


H 


= 


'hexadecimal 





= 


octal 


,Q 


=:: 


octal 


B 


= 


binary ■■?■.' 



•i.\>. 



I'f^the letter is omitted,, the number, i s assumed to be 
decimal. Q is usually perferred for .oc!tal constants , since 
is so easily confused with : .,J0 (zerq) f f Numeric' constants. 
must begin with a numeric, character (0-9) so r ,that 'they can 1 f;,. 
be distinguished from labels; a hexadecimai~ constant 
beginning with A-F must be preceded by a zero. .,,u ,,.,:, 



yVJ-H; 



ASCII constants are one or two characters surrounded by 

^single quotes (')• A single quote within an ASCII constant 

is represented by two- single quotes in a row with no 

intervening spaces." For' example, the expression ,,,, f where 

the two outer quote marks represent the string, itself , i.e., 

.the single quo te '"'char acter • A single character ASCII 

constant has the numerical value of the corresponding ASCII 

co'de.„ ... A double character /ASCII constant has the 16-bit 

value, whose high-order byte is the ASCII code 1 of the first 

^character and whose lbw-or.<J"er.' byte is the ASCII code of the 

isecond character. '! 

,, If a constant i s -used wrier e.r an 8-bit quantity is required 
' (e.^g. ,r MVI C, 10H) , its numeric* value must lie in the range 



nTi! ';0. .,;.* 



M HV 



